home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / relnotes / performer_eoe / ch2.z / ch2
Encoding:
Text File  |  2002-10-08  |  10.5 KB  |  330 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information supplemental to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e. The information listed here is
  12.        product-specific; use it with the Installation Guide to
  13.        install this product.
  14.  
  15.  
  16.        2.1  _P_r_e_r_e_q_u_i_s_i_t_e_s
  17.  
  18.  
  19.        To use OpenGL Performer 2.5 and its binary-compatbile
  20.        successors (2.5.1, 2.5.2, etc) your system must be running
  21.        IRIX 6.5 or later.  OpenGL Performer 2.5 supports all
  22.        graphics system configurations that are running at least
  23.        IRIX 6.5.  In order to develop MIPS-III/IV applications you
  24.        must install the appropriate selection of N32 and N64
  25.        subsystems as listed in the distribution.  N32 and O32 are
  26.        combined as the standard system default.  OpenGL Performer
  27.        developers will also need a C or C++ compiler, the Performer
  28.        database loaders, and associated software development tools
  29.        and libraries.
  30.  
  31.  
  32.        OpenGL Performer is dependent on the general system
  33.        configuration so there are things outside of the OpenGL
  34.        Performer 2.5 distribution that you will need.  If running
  35.        IRIX 6.5, we strongly recommend upgrading to the latest
  36.        overlay version.
  37.  
  38.        Prerequisites for OpenGL Performer 2.5 for Linux are listed
  39.        in the on-line notes installed in /usr/doc/performer-2.5
  40.        (Linux only).
  41.  
  42.  
  43.        2.2  _O_p_e_n_G_L__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m_s
  44.  
  45.  
  46.        Many subsystems comprise the OpenGL Performer execution
  47.        environment distribution.  These subsystems are not all
  48.        required for a proper installation.
  49.  
  50.        The IRIX environment spans two machine architecture levels
  51.        -- the 32-bit MIPS I/II instruction set and the 64-bit MIPS
  52.        III/IV instruction set -- along with two versions of 32-bit
  53.        support -- the old caller-save register management protocol
  54.        known as Old-32 and the newer callee-save register
  55.        management protocol termed New-32 (N32) -- so there are
  56.        actually three versions of each library: O32, N32, and N64.
  57.        The _f_i_l_e2 IRIX shell command can tell you what version of
  58.        the MIPS instruction set is being used by a given
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        executable.  The O32 and N32 libraries are combined in a
  75.        single subsystem to simplify installation.
  76.  
  77.        This multidimensional complexity is hidden within OpenGL
  78.        Performer since the APIs are unchanged between the versions.
  79.  
  80.        The subsystem naming conventions are designed to be simple
  81.        and regular:
  82.  
  83.           +o Old-32 32-bit mips-2 and New-32 32-bit libraries are in
  84.             ".sw" subsystems.  The Old-32 were the standard IRIX
  85.             6.2 libraries and are now provided only for backwards-
  86.             compatibility.  They may be removed in a future
  87.             release.  The New-32 libraries were introduced with
  88.             IRIX 6.2 and operate with increased efficiency in many
  89.             situations.  N32 is the default mode of operation in
  90.             OpenGL Performer 2.5.
  91.  
  92.           +o New-64 64-bit libraries are in ".sw64" subsystems.
  93.  
  94.           +o Only the optimized libraries are included in the
  95.             execution environment.
  96.  
  97.        A few simple examples should make the naming conventions
  98.        clear:
  99.  
  100.           +o performer_eoe.sw.performer: O32 and N32, OpenGL,
  101.             Optimized, DSO
  102.  
  103.           +o performer_eoe.sw64.performer: N64, OpenGL, Optimized,
  104.             DSO
  105.  
  106.        OpenGL Performer includes these subsystems whose names were
  107.        composed following the conventions outlined above:
  108.  
  109.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a
  110.             Sample Data and Fonts.  Need for the demos, installed
  111.             by default.
  112.  
  113.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n
  114.             The Performer Town demo data.  Needed for the demos,
  115.             installed by default.
  116.  
  117.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o
  118.             Reference pages for demo programs.  Installed by
  119.             default.
  120.  
  121.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w._d_e_m_o
  122.             Demo executables (n32, OpenGL).  Installed by default.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o
  141.             Demo executables (n64, OpenGL).
  142.  
  143.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._p_e_r_f_o_r_m_e_r
  144.             N32 and O32 DSOs.  Required for basic operation.
  145.             Installed by default.
  146.  
  147.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r
  148.             N64 DSOs.  Only required for 64-bit operation.
  149.  
  150.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__0
  151.             Performer 2.0.7 Compatibility DSOs.
  152.  
  153.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__1
  154.             Performer2.1.5 [2.1-2.1.4] Compatibility DSOs.
  155.  
  156.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__2
  157.             Performer2.2.15 Compatibility DSOs.
  158.  
  159.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__4
  160.             Performer2.4.4 Compatibility DSOs.
  161.  
  162.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__0
  163.             N64 64-bit Performer2.0.7 Compatibility DSOs.
  164.  
  165.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__1
  166.             N64 64-bit Performer2.1.5 Compatibility DSOs.
  167.  
  168.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__2
  169.             N64 64-bit Performer2.2.15 Compatibility DSOs.
  170.  
  171.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__4
  172.             N64 64-bit Performer2.4.4 Compatibility DSOs.
  173.  
  174.  
  175.        2.3  _O_p_e_n_G_L__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  176.  
  177.        This section lists the subsystems (and their sizes) of the
  178.        OpenGL Performer option.
  179.  
  180.        If you are installing this option for the first time, the
  181.        subsystems marked ``default'' are the ones that are
  182.        installed if you use the ``go'' menu item.  To install a
  183.        different set of subsystems, use the ``install,''
  184.        ``remove,'' ``keep,'' and ``step'' commands in _s_w_m_g_r or _i_n_s_t
  185.        to customize the list of subsystems to be installed, then
  186.        select the ``go'' action.
  187.  
  188.        Note:  The listed subsystem sizes were taken shortly before
  189.               release and are approximate.  Refer to the _I_R_I_S
  190.               _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information on
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.               finding exact sizes.
  207.  
  208.        Subsystem Name                         Subsystem Size
  209.                                               (1k-byte blocks)
  210.  
  211.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a (default)          27360K
  212.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n (default)           6250K
  213.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o (default)              50K
  214.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w._d_e_m_o (default)              960K
  215.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o                     1020K
  216.        _p_e_r_f_o_r_m_e_r__e_o_e._m_a_n._r_e_l_n_o_t_e_s (default)          160K
  217.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__0                        27380K
  218.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__1                        30040K
  219.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__2                        73140K
  220.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__4                        42210K
  221.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._p_e_r_f_o_r_m_e_r (default)        45080K
  222.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__0                       7680K
  223.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__1                       8430K
  224.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__2                      21270K
  225.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__4                      22830K
  226.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r                24290K
  228.  
  229.  
  230.        2.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  231.  
  232.        All of the OpenGL Performer subsystems can be installed
  233.        using IRIX.  You do not need to use the miniroot.  Refer to
  234.        the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete
  235.        installation instructions. Detailed information about both
  236.        the _s_w_m_g_r and _i_n_s_t installation management tools is
  237.        available through the _m_a_n and _x_m_a_n commands.
  238.  
  239.  
  240.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  241.  
  242.  
  243.        This distribution contains the OpenGL Performer 2.5
  244.        execution environment which also contains compatibility
  245.        subsystems with bug fixes for previous versions of IRIS
  246.        Performer and OpenGL Performer.  Applications compiled with
  247.        the Performer 2.4, 2.2, 2.0 or 2.1 DSOs will run unmodified
  248.        with the 2.4.4, 2.2.15, 2.0.7 and 2.1.5 DSOs, respectively,
  249.        across all SGI platforms.  The Performer DSOs are versioned
  250.        so DSOs from multiple versions of Performer can co-exist and
  251.        applications will automatically run with their proper
  252.        version.  OpenGL Performer 2.3 was only shipped on Linux
  253.        platforms and those DSOs are not bundled with this release
  254.        for IRIX.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                   - 5 -
  268.  
  269.  
  270.  
  271.        2.6  _I_n_s_t_a_l_l_a_t_i_o_n__L_o_c_a_t_i_o_n_s
  272.  
  273.        The OpenGL Performer execution environment places DSOs under
  274.        "/_u_s_r/_l_i_b", "/_u_s_r/_l_i_b_3_2", and "/_u_s_r/_l_i_b_6_4" for O32, N32, and
  275.        N64 versions, respectively.
  276.        The compiled versions of the database loading and utility
  277.        libraries are placed under "/_u_s_r/_l_i_b/_l_i_b_p_f_d_b",
  278.        "/_u_s_r/_l_i_b_3_2/_l_i_b_p_f_d_b", and "/_u_s_r/_l_i_b_6_4/_l_i_b_p_f_d_b".
  279.        It is these libraries that are dynamically loaded and which
  280.        must be accessible for Performer applications to
  281.        successfully execute.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.